T1_Audio_Spec [DRAFT v0.1].md

canon/tiers/01_Tier_1_Foundation/T1_Audio_Spec [DRAFT v0.1].md

T1_Audio_Spec [DRAFT v1.0]

§0 What this document is, and what changed

This is the owning Tier-1 document for the audio domain. Until this version it was a two-line title with no body, and the domain's ruled canon lived scattered across proposal-tier program documents, technical dossiers, the decisions register and the pipeline ledger. The ledger names that absence directly: the C9 VO row records "T1_Audio_Spec [DRAFT v0.1] is a 2-line empty stub" as the canon-home gap (docs/PIPELINE_LEDGER.md §4 row C9), the F1 music row repeats it (§7 row F1), the F2 SFX row records "no T1 owner (T1_Audio_Spec stub)" (§7 row F2), and §11 carries lifting the stub as a named work order (§11, VETOABLE 3).

This version is CONSOLIDATION, not invention. Every bar, rule and posture below is lifted from an existing ruling, doctrine, dossier or registry and carries its citation. Where the sources contradict one another, the resolution and its reasoning are stated in the body and the residue is carried to §10 rather than smoothed over. Nothing genuinely new is absorbed silently into the body.

The document is authored to DRAFT. A fresh-context critic gates any DRAFT-to-ACTIVE flip.

§1 Authority and scope

1.1 What this document owns

This document owns the audio domain: what the game's music, sound effects, foley and voice must BE, the quality bars they are held to, the care discipline that governs them, and the evidence a claim about them has to carry. It owns the four audio surfaces as one domain, because the region-page template already treats them as one consumption unit and the doctrine, the rubric and the dossiers all cross-reference each other constantly (docs/translation/T99_Translation_Audio.md §1).

1.2 Where it sits in the authority hierarchy

1.3 The T0 registries this document owns row-level canon for

1.4 The proposal-tier program documents this document governs

Each of these remains the working HOW for its lane and each is subordinate to this document.

§2 The standing direction — the ruled bars

These six are Josh's own direction for the domain, recorded 2026-07-29 and reaffirmed since (PIPE_AUDIO_MUSIC §0). They are the bars every deliverable in this document serves.

2.1 The thirty-year bar

Music so nostalgic people will play it for thirty years. The exemplar lineage is broad — SNES-era, Zelda, Undertale, Sonic, Super Mario 64, Skyrim, Halo, Pokemon, Animal Crossing, Donkey Kong — scores that live outside their games. They endure on melody and leitmotif, not production sheen (PIPE_AUDIO_MUSIC §0, the thirty-year bar).

Josh expanded the bar on 2026-08-05: twelve to twenty different and unique tracks per chapter, two to seven minutes each, inspired by the cultural region and its authenticity and then made into a masterpiece, evaluated against real exemplars whose formulas are derived by measurement (MASTERPIECE_PROGRAM §0). Against seventy-nine nodes that is nine hundred and fifty to sixteen hundred tracks, and the program's answer to that arithmetic is a leitmotif economy rather than a library: a track is a motif crossed with a regional palette crossed with a purpose class, each of the three authored once and combined per chapter (MASTERPIECE_PROGRAM §1 and §5).

2.2 Melody first, and the hummability test

Hero and canonical themes are leitmotif-first. If a theme cannot be hummed after one hearing, it is not the theme yet. Themes iterate until they pass, judged with evidence like everything else (PIPE_AUDIO_MUSIC §0, melody-first and the hummability test). A theme does not proceed on schedule pressure (COMPOSER_BRIEF_PACK §8).

2.3 Per-culture, per-period scoring

Josh's verbatim direction: music is tuned to fit each culture and their time period, using instruments, chants, vocals where appropriate but mostly no vocals other than hums chants and harmonies, ambient noises. Period-appropriate instrumentation per region; vocals default wordless; ambient texture is part of the score (PIPE_AUDIO_MUSIC §0, per-culture per-period scoring).

2.4 The sourcing law

Reference-composition to a culture's musical register is permitted; sampling or reproduction of consecrated performance never is (PIPE_AUDIO_MUSIC header ruled-state line and §4). The doctrine makes the law executable rather than paralysing by splitting grammar from repertoire: grammar is free everywhere — mode and final, reciting tone, form-shape, ornament class, ensemble behaviour, drone behaviour, timbre class, tuning system, timeline — while specific transmitted repertoire, real liturgical or scriptural text, and any sampled or model-conditioned recording of consecrated performance are excluded everywhere (MUSIC_COMPOSITION_DOCTRINE §3.4).

2.5 The concert-performable orchestral bar

Full orchestras will perform this playlist at concerts, operas and Broadway. The hero-theme lane's deliverable is a composed work, not just rendered audio: real notation that a human orchestra can sit down and play. Rendered stems serve the game build; the score serves the concert hall; both come from the same composition (PIPE_AUDIO_MUSIC §0, the concert bar; MUSIC_COMPOSITION_DOCTRINE §5.1).

2.6 The theory-depth directive

Josh's verbatim direction: you will need to understand music theory in depth to create this, understand the patterns, and how everything comes together (PIPE_AUDIO_MUSIC §0, the theory-depth directive). The doctrine is the artifact that discharges it, and no theme authors without it.

§3 Music direction

3.1 Melody is the artifact

A cue is delivered when a tune survives it, not when a mix sounds good (MUSIC_COMPOSITION_DOCTRINE §0.1 first law). Three consequences bind.

The head-cell law, binding and scoped. Every canonical theme whose motif_class is tune is built on a three-to-five-note head cell, singable inside a ninth, rhythmically distinct enough to be tapped without pitch, and either triad-outlining or purely stepwise — chosen deliberately per motif, never both. Exactly one deviant element carries identity: one unusual leap, one borrowed degree, one metric oddity. Two deviants and it stops being hummable (MUSIC_COMPOSITION_DOCTRINE §1.2). The law is scoped to motif_class tune because the roster contains identities that are deliberately not tunes, and a row with motif_class unset cannot be scored and cannot be rendered (MUSIC_COMPOSITION_DOCTRINE §1.3).

3.2 The leitmotif architecture

Twenty-two threads do not get twenty-two independent themes; that exceeds any listener's recognition budget and produces mush (MUSIC_COMPOSITION_DOCTRINE §1.4). Three tiers.

The transformation catalogue is reserved vocabulary, not decoration. Mode shift means moral or fortune reversal; augmentation means weight, memory, ceremony, death; diminution means panic or pursuit; fragmentation means foreshadow before reveal and is the combat-layer form; reharmonisation means wonder or revelation; contour inversion means corruption or the double; metric recast means culture and era relocation; combination is the most expensive and most earned event, a new dramatic condition; closure change is the payoff itself. An operation used without a dramatic reason is drift, and a Tier-A motif budgets six to ten distinct transformations across the game (MUSIC_COMPOSITION_DOCTRINE §1.6).

Payoff architecture across dozens of hours. Withhold closure — reserve the authentic cadence on the tonic for one node in the whole game, write the resolution first, then delete it from every earlier statement. Plant diegetically — a motif the player physically inputs is retained far better than one merely heard. The single-theme arc — the Prologue statement and the Ch-77 statement are the same tune and the player must feel the distance. Recombination as reveal — motif combination states a relation with no dialogue (MUSIC_COMPOSITION_DOCTRINE §1.7).

Reveal discipline is a music gate, and it is mechanical rather than promised. Every theme row carries reveal_gate. Before its gate, only a disguised or inverted derivation of a gated motif may sound, and its kinship must be inaudible to a fresh listener (MUSIC_COMPOSITION_DOCTRINE §1.8). The live registry carries reveal gates on eleven of thirty-eight rows: four at CH_38, three at CH_76, four at CH_77. The cue emitter refuses to emit any cue whose reveal_gate is later than its own chapter if the cue name, its site or its trigger context carries a held token, the gate source fails closed on an unparseable or contradictory value, and must-fire fixtures prove both refusals fire (LEITMOTIF_ARCHITECTURE §3.4, the firewall). The antagonist pattern is the hardest case: fragmentation is the only operation permitted before Ch 38, a different local carrier every time, one statement per node, never the phrase, never a swell, never on a face (LEITMOTIF_ARCHITECTURE §3.4; COMPOSER_BRIEF_PACK §2).

3.3 The measurement instruments

The bar is held by instruments that can fail, not by assertion.

3.4 How the melody is actually made, as measured

The 2026-08-05 melody A/B answered this by measurement rather than preference, and its finding is binding on the lane (PIPE_AUDIO_MUSIC §8).

3.5 The generated-audio posture, and the licence law

3.6 The spend gates and the publish gate

3.7 Adaptive delivery

The composition must survive interactivity, and two consequences bind the composition itself.

§4 Sound effects

4.1 The registry is the data home

T0_SFX_Registry [ACTIVE v1.0] carries 680 rows across 41 columns and is the addressable unit of work for the lane. Addressing is already ruled and already columned: sfx_id to ue_sound_asset_path, final asset at /Game/Audio/SFX/SFX_<sfx_id>, swap by path takeover, with cue-fired telemetry and a muted-wired fixture as the standing teeth (PIPE_AUDIO_MUSIC §3).

The registry's realization state is honest and low: 662 of 680 rows carry no ue_sound_asset_path, every row reads generation_status pending, and generation_method, build_asset_path, sound_designer_in_loop_required and generation_licence_ref are empty on every row. Against that, the import chain works and 41 assets are in-engine — a six percent realization rate on a fully populated registry (docs/PIPELINE_LEDGER.md §7 row F2).

4.2 Licence posture and the authored-versus-generated split

4.3 Grading posture

Zero SFX rows are graded today. The lane is exemplar-first: one SFX family — the combat impact family is the ledger's named candidate — is graded against the feel comparators before the factory runs (docs/PIPELINE_LEDGER.md §7 row F2). The impact-audio cue shape is inherited rather than invented: a two-part envelope of low-end weight resolving into a high-frequency read, with hit-stop a shared audio and animation moment, and tier escalation expressed as a low-end mass delta while the high-frequency identity read is held constant (PIPE_AUDIO_MUSIC §7.2).

Audio is wired at authoring time, not added as a post-pass. The proving map the art and animation lanes converged on carries cue audio wired at authoring time, so one surface serves screenshot and listen together (PIPE_AUDIO_MUSIC §7.1). The audio binding is declared on the entity row, where the entity is authored, rather than re-derived in a separate wiring step (§7.3).

The standing gate sfx_coverage certifies that every row is categorised or declared-waived, and reads 680 of 680 categorised with 23 of 23 fixtures at the time of writing (harness/gates_config.json; harness/sfx_coverage_scorecard.json).

§5 Foley and footstep

Foley is the domain's best-wired lane and its wired shape is the shape of done for every other audio class. In-engine today: HumanityFootstepComponent, DABP_FoleyAudioBank, ten BP_AnimNotify_FoleyEvent_* notifies covering walk, run, jump, land, scuff and hand-plant left and right, and HumanitySurfacePhysicalMaterial, with Content/Audio/Mix present (docs/PIPELINE_LEDGER.md §7 rows F3 and F2).

§6 Voice and VO

6.1 The canon lines

Per CVD §15.1, every option is fully written and fully voiced. The game does not use short-form voiced responses with read-only text options; all six options at every dialogue node receive the same voice-acting treatment (T3_Core_Characters [ACTIVE v1.0] §2.5). Synthetic generation operates during development; professional cast recording follows post-crowdfunding against the established biography-parameter voice profiles, with actors performing multiple takes across biography states (T3_Core_Characters §2.5).

The voice the player hears is the voice their biography parameters compose at that moment, and the register modulates continuously rather than stepwise across the five integrity bands: warm and centred at Truly Good, steady across the widest emotional range at Good Enough, neutral with the angular wisdom register at Drifting, clipped and less resonant at Evil, operational coldness at the Pure Evil terminal band — never theatrical, never villainy performance (T3_Core_Characters §2.5). Six options per beat, silence always valid where context supports it, biography options unmarked and path options subtly marked (T3_Core_Characters §2.4).

6.2 The partial-VO ship ruling, as data

The ship policy is partial VO, and it lives as a per-line column rather than as prose, because a policy that lives only in a decisions register cannot be executed or audited (T99_Translation_Audio §2.4; docs/spine/DECISIONS_PENDING_JOSH.md twenty-sixth sitting item 4).

There is no runtime TTS lane in canon and this document does not create one; voice generation is bake-time only (PIPE_VOICE scope line).

Reconciling the two: CVD §15.1's fully-written-and-fully-voiced is the SHIPPED-GAME canon and remains the destination. The partial-VO ruling governs what the pre-crowdfunding build ships while professional cast recording is unfunded. The vo_tier column is the mechanism that records the distance between the two honestly per line, rather than letting a build silently claim the canon line it has not yet met.

6.3 Voice substrate posture

6.4 The natural-voice register

Every player-facing line sounds like a person, and music and voice are both player-facing surfaces (docs/NATURAL_VOICE_DOCTRINE.md §1; MUSIC_COMPOSITION_DOCTRINE §0).

§7 Care — CVD §17.1 at the audio layer

The care standard is CVD §17.1 and this document adds no second policy on top of it; it states the audio-layer expression of the same discipline (T99_Translation_Audio §2.7). Care means weight and authenticity. Care never means omission, reverence-gloss or rated-G sanitization (CVD §17.1). Care-tier inflation is itself a defect and the timid option is usually the wrong one (CVD §17.1 calibration paragraph). The hard-line floor is the only absolute and never loosens (CVD §17.1 calibration paragraph).

§8 Production, evidence and QA

8.1 The exemplar-first law

An audio class runs its factory only after one exemplar of that class has passed. Zero graded exemplars exist in any audio class today: F1 music records 20 staged tracks, none graded; F2 SFX records 0 graded; F3 foley records 0 graded (docs/PIPELINE_LEDGER.md §7 rows F1-F3). The named exemplars are one hero theme to final-candidate against the exemplar corpus, one SFX family graded against the feel comparators, one surface's full foley set graded in-game for feel, and one six-option dialogue beat fully voiced and played in-engine (docs/PIPELINE_LEDGER.md §4 row C9 and §7 rows F1-F3).

8.2 The honest tier register

Every claim about audio quality carries its tier, and the tier does real work rather than decorating a report.

8.3 Critic gates and instrument honesty

8.4 Definition of done, split by what it gates

The split exists because a set of unreachable concert-hall requirements would otherwise block the GAME build of every hero theme in a solo pre-revenue project (MUSIC_COMPOSITION_DOCTRINE §5.9).

8.5 Format and integration contract

§9 The state of the domain, recorded honestly

Stated so that no later reader mistakes a populated registry for a realized one.

§10 Open items flagged to the director

Nothing in this section is absorbed into the body above. Each is either genuinely new, or a live contradiction between sources that this document is not authorised to rule.

10.1 Composer-in-loop: two rulings on record, one day apart, pointing opposite ways

This is the sharpest contradiction in the domain and it is a Josh-level fork, not a drafting choice.

10.2 The concert deliverable and the retirement do not fully reconcile

The concert-performable bar asks for a composed work an orchestra can read, and the doctrine's two-deliverable law makes the score the master and the render a build of it (MUSIC_COMPOSITION_DOCTRINE §5.1). Under the generation lane the order inverts: the render is authored first and the notation is extracted from it (COMPOSER_BRIEF_PACK §8). The authored method has since moved the lane back toward the concert bar — an authored score is already the thing an orchestra could read (PIPE_AUDIO_MUSIC §8, the next lever) — but no orchestral MusicXML pass exists and the concert definition of done has never been opened for any theme. Flagged, not resolved.

10.3 Doctrine gate 5 is met only in part, and the outstanding half is owed

Plant node and diegetic surface now exist as columns on the live T0_Theme_Registry but are deliberately unpopulated, on the grounds that a diegetic surface exists in a node and must be assigned by a lane that has read that node. A first render has already landed and been served with half its gate unrepresented (LEITMOTIF_ARCHITECTURE §5, doctrine gate 5). Owed before the next render of any Tier-A row: a plant node and a diegetic surface per Tier-A theme, assigned from the spine entry it plants in, with the protagonist theme first.

10.4 The recurrence anchors are unpopulated by design and the firewall is unarmed until they land

The antagonist pattern's pre-gate statements are deliberately not placed, because a hand-typed anchor list would be exactly the invented-canon failure the repo gates against. The reveal firewall arms itself the moment the first anchor lands (LEITMOTIF_ARCHITECTURE §3.4, the recurrence anchors). Until then the firewall's teeth exist and have nothing to bite. Named so nobody reads the armed emitter as an armed gate on real content.

10.5 T0_Motif_Registry at one row

One motif row under a melody-first thirty-year bar is the domain's sharpest data gap (docs/PIPELINE_LEDGER.md §7 row F1). Whether the motif bank of forty to sixty motifs the masterpiece program calls the highest-value authoring in the whole program (MASTERPIECE_PROGRAM §7, rung 4) lands in T0_Motif_Registry or is absorbed into T0_Theme_Registry's Tier-B and Tier-C rows is an unanswered registry-shape question. It is a canon-adjacent act and is named here rather than decided.

10.6 Two dossier statements are stale against the live tree

10.7 The registry-extension conformance gap on generated audio

T0_SFX_Registry carries generation_status, generation_prompt_hash, last_generated_timestamp and regeneration_trigger as columns, but generation_method, sound_designer_in_loop_required, build_asset_path and generation_licence_ref are empty on all 680 rows, and generation_status reads pending on all 680. The five-state generation lifecycle and the licence law therefore have columns but no values. This is population, not schema, and it belongs in a batched registry pass with one fidelity re-baseline in the same commit (PIPE_AUDIO_MUSIC §3, the two verified state facts).

10.8 The music exemplar corpus carries one known-false row and one open matcher defect

EX_014 stands ACQUIRED against audio from the wrong franchise, deliberately, with its own note saying the question is answered by buying the album and looking rather than by the tool (docs/PIPELINE_LEDGER.md, MUSIC CORPUS INTEGRITY, 2026-08-07). The seventh poison pair — a row whose game tokens are a strict subset of a file's — is open, and a wholesale rescan must not run until the game floor scores containment asymmetrically (docs/PIPELINE_LEDGER.md, MUSIC CORPUS — THE STARTER TEN LANDS, 2026-08-07). Both are recorded on the corpus's own defect register; both are carried here because they bound what the measurement rig may claim.

10.9 The Care-Doctrine benchmark question is still unrun

The benchmark's cultural-substrate question — do region prompts produce plausibly registered instrumentation, or a generic wash — was never run, because all twelve region cells are correctly held pending the elevated-care read. Nothing in the landed benchmark evidence may be cited on it (PIPE_AUDIO_MUSIC §6 item 6 and §6.0's scope line). This is the domain's largest open care gate.

10.10 No dedicated audio comparator research has ever been run

Everything the comparator program contributed to this domain was routed from lanes looking at something else. Four questions a real pass would answer remain unanswered: how shipped AAA titles structure an adaptive music system's authoring surface, how SFX libraries are organised and versioned at scale, how VO is routed and QA'd against script churn, and how mix and loudness are validated automatically. The thirty-year melodic bar in particular has no comparator anchor (PIPE_AUDIO_MUSIC §7.6). Boarded, not done.

10.11 Beyond-floor items this document proposes, named for veto

Per the standing law that Josh's comments are the floor and the loop expands beyond it, three items below are this document's own additions rather than restatements of a ruling.

Generated by harness/site/structure_site.py — the URL path is the repo path. review root